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Chapter 1 


Window Manager API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


This specification describes the Window Manager public APIs as provided in LiMo Foundation Platform 
Release 1. 


The document specifies how LiMo applications can make requests to the LiMo Window Manager. 


The Window Manager provides APIs for the following Window Manager functions: 


e Window Manager registration 
e Window Management 

+ Key delivery 

e Screen 

e Input mechanism 


+ Case movement mechanisms 


Note, many of the APIs described in this specification explain that requests made by client applications to 
the Window Manager will be subject to conflict management enforcement. However, the Window Manager 
will not check for conflicts in LiMo Foundation Platform Release 1 as the conflict management component 
is outside of the scope of this release. 


1.3 2.1 Definitions, Acronyms and Abbreviations 


Application Program: A program that can be launched only by the Application Launcher. It must have a 
window. It must have an application program ID and an application instance ID. The Application Launcher 
must provide functionality to launch Application Programs and Service Programs. For the purposes of this 
WM API specification, an application is regarded as a LAF Application; an application that is managed by 


2 Window Manager API 


the Application Framework provided in LiMo Foundation Platform Release 1. For further details see the 
LiMo Software Architecture Document. 


Background Application UI State: The application is visible on the screen to the user but is not in focus. 


Blocking API Call: Processing in the thread (or process if threads are not used by the application calling 
the API) will be suspended pending the response from the Window Manager. 


Case Movement: The change in a handset’s physical configuration due to operation of the handset by the 
user (eg, opening a clam shell or pushing open the slider mechanism). 


Default Application: This application, specified by the handset vendor, should always be available to 
display its user interface when no other application is running. This is usually the Idle Screen application. 


Focus: A window has focus (or is focused) if it is the target receiving input from the user at a given time. 
Foreground Application UI State: The application is visible on the screen and has focus. 


Inter-application Window Group: This is a set of standard window groups which belong to different 
applications which are interrelated. 


Invisible Application UI state: When the application is notified of Invisible UI state the application can 
free up resources no longer needed, e.g. unmap windows. 


Mapped Window: A mapped window is eligible to be displayed on the screen when the window is not 
fully overlapped by other windows. 


Screen: A Server may provide several independent screens, which may or may not be physical independent 
hardware. 


SPEF (Security Polices Enforcement Facility): Security component within LiMo. 
Standard Window Group: A group of Top-Level Windows within one application. 


Unmapped Window: When a window is unmapped it is removed from the WM stack and thus will no 
longer be visible. 


Window: Within the UI Framework a ’window’ is defined to mean a rectangular, bounded area of the 
mobile handset’s display within which a single application interacts with the user by means of user interface 
widgets. An application may use one or more windows to interact with the user. 


Window Manager: Responsible for managing Top-Level windows registered by applications. 


Window State: A window has an internal state, which indicates whether it has been mapped to the display 
by the application or not. 


1.4 Industry Standard 


None 


1.5 External API Documents 


None 


1.6 Plug-in Extension Point Interface 


The Window Manager functionality can be customised by the LiMo Vendor in the following areas: 
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1.7 Other Interfaces 


e Key Adapter 
+ Extended Input Event Plug-ins 


e Case Movement Event Plug-in 


1.7 Other Interfaces 


None 


1.8 Other Notes 


None 
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Chapter 2 


Module Index 


2.1 Modules 


Here is a list of all modules: 


Foundation APIs - Function Details .......... o... o... e... . o... 11 
WM Specialist APIS s,s... aia a A See k ees SA E 12 
WM Key Handling APIS šui deee a ER S A R 15 
WM Event Registration APÍS .......... ee 18 

Foundation APIs - GTK Interaction with Window Manager ..................-.. 20 
WM Registration APIs ............ a 21 
WM Window APIS + K koss 4 64.046 .@4 6 45 R RE OR ee | eS Ž2 
WM Key Settings -APIS 4 044.4 k ed Soa sk edo Se was 22 
WM Screen APIS: senerare ee be ROE E RAR 37 

Framework APIS) ce ka pa a ad a a SE wes 40 
Key Adapter interfaces: os k RY ee ee De Aw A CR ee ee RR 41 
Input Plug-in interfaces. sss saa ee 44 


Case Movement Plug-in interfaces 


Module Index 
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Chapter 3 


Data Structure Index 


3.1 Data Structures 


Here are the data structures with brief descriptions: 


AppUIWmAppProperties (Details the application custom parameters) .............. 
AppUIWmKeyInfo (This structure stores the keycode and type of a key event) ......... 


AppUIWmPluginData (Input plug-in additional information ) 


Data Structure Index 
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Chapter 4 


File Index 


4.1 File List 


Here is a list of all files with brief descriptions: 


ComponentOvervie wi css pi rr ba Ree Re ERE ee Re Ee eS 33 
imowmAdapiethi 6 cb hk ks ee a i a E k oe 54 
limọoWmádapter Vendor k RR oe ee ee 33 
ir a M RA TT 58 
mo ME SRC PUŠELĖ ooe eek ks A Bee a a a A a a 60 
lima WimCasePhigin VEndOr coses k k ee 61 
limoWminpiPlugin h cos sas ee k e BS Be ee eo Be Ge et dss 62 
limoWmInputPloginVendorb Lk ee eee. 63 


OS RINDE eis aes a A OR A A A Se Bas 64 
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File Index 
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Chapter 5 


Module Documentation 


5.1 Foundation APIs - Function Details 


5.1.1 Detailed Description 


The section summarises all of the public functions within the Window Manager API, which are not sup- 
ported by the LiMo GTK APIs. 


Most of the Window Manager API’s will be called within the LiMo GTK, for a list of these APIs see 
the GTK interaction with Window Manager module; the remaining APIs need to be explicitly called by 
applications and are detailed in this module. 


Modules 


e WM Specialist APIs 
e WM Key Handling APIs 
e WM Event Registration APIs 
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5.2 WM Specialist APIs 


Functions 


e int AppUIWmGetCurrentUIState (AppInstanceld appId, AppUIAppUIState *appUIState) 


Get current UI state from the WM. 


+ AppUIWmErrorReason AppUIWmGetLastErrorReason (AppInstanceld appld, const char 
+xerrorString) 


Reguests further details on the error received from the WM. 


+ int AppUIWmReguestInputFocus (AppInstanceld appId, AppUIWindowld windowID) 


Requests WM to bring one of the applications top-level windows to the foreground. 


e int AppUIWmQueryAppInstances (AppInstanceld appld, int «size, int ++buffer) 


Queries WM for a list of application instances. 


5.2.1 Function Documentation 
5.2.1.1 int AppUIWmGetCurrentUIState (AppInstanceld appId, AppUIAppUIState + appUIState) 


Get current UI state from the WM. 


Returns the application instance’s UI State to the application. 


+ This API function call is non-blocking. 


e Applications need to have registered (AppUIWmkRegisterApplication()) otherwise APPUI_WM_- 
STATE_NULL will be returned. 


Parameters: 
— appld Application Instance ID. 


=> appUIState Returns the current UI State of the application: 
APPUI WM STATE NULL 
APPUI WM STATE INVISIBLEĖ 
APPUI WM STATE BACKGROUND 
APPUI WM STATE FOREGROUND. 


Returns: 


OPERATION SUCCESS: normal end 
ERR OPERATION.  FAILED: Error occurred whilst retrieving the UI state. 


5.2.1.2 AppUIWmErrorReason AppUIWmGetLastErrorReason (AppInstanceld appld, const 
char xx errorString) 


Requests further details on the error received from the WM. 
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e When the WM returns ERR OPERATION, FAILED, the application can query this failure in more 


detail. 


e Only the 


last error can be retrieved from the WM. 


+ If no error has occurred then APPUI WM. NO ERROR will be returned, and error string will be 
unchanged. 


+ This API function call is non-blocking. 


Parameters: 


— appld Application Instance ID. 


> errorString The errorString will contain a pointer to a null terminated string containing the textual 


descr 


Returns: 


APPUI_W 
APPUI_W 
APPUI_W 
APPUI_W 
APPUI_W 
APPUI_W 
APPUI_W 
APPUI_W 


iption of the error ID. 


M_ILLEGAL_PARAMETER, 
M_SECURITY_FAILURE, 
M_CONFLICT_ERROR, 
M_REQUEST_REJECTED, 
M_INTERNAL_ERROR, 
M_INVALID_SEQUENCE, 
M_KEYHOOK_ALREADY_USED, 
M_NO_ERROR. 


5.2.1.3 int AppUIWmQueryApplnstances (AppInstanceld appld, int x size, int xx buffer) 


Queries WM for a list of application instances. 


This API is targeted for the Application Window Switching UI component, enabling it to obtain a 


list of Application Instance IDs; only applications that have Top-Level Windows registered with the 
WM will be included. 


For inter 


the WM 


Parameters: 


application window groups only the application instance at the top of the group is reported. 


The list of Application Instance IDs are provided in the order of the window groups provided within 


Stack. 


The application is responsible for releasing the buffer once it has finished with the information. 


This API is protected and subject to vendor SPEF policy. 


Applications need to have registered (AppUIWmRegisterApplication()). 
This API function call is blocking. 


— appld Application Instance ID. 


— size The size of the buffer. 


> buffer The buffer contains a list of Application Instance IDs of applications that have top-level 
windows registered with the WM. 
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Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst attempting to get the application Instance IDs. 


5.2.1.4 int AppUIWmReguestInputFocus (AppInstanceld appId, AppUIWindowld windowID) 


Requests WM to bring one of the applications top-level windows to the foreground. 


Application sends a request to WM to change which of its top level window, within its standard 
window group, should receive focus. 


WM first checks the application’s standard window group is at the top of the WM stack. If not, the 
request is rejected and an error is returned. 


The Window Manager will check to ensure that the screen the window is displayed on is capable of 
receiving focus. 


The Window Manager will check if the window to be brought to the foreground has been set to 
invisible, if it has, the request will be rejected. 


If the standard window group is at the top of the WM stack, the WM will apply the application 
switching lock to prevent further application switching requests and then stop key reporting to the 
current window. 


The specified Top-Level Window will then be raised to the foreground. 


Focus will be transferred to the window that has been brought to the foreground. 


The WM will then restart key reporting to the new top level window and release the application 
switching lock. 


Applications need to have registered (AppUIWmRegisterApplication()). 


The specified Top-Level Window must be registered (AppUIWmRegisterTopLevelWin()) before 
calling this API (if applications are using LiMo GTK, this will be satisfied by creating a new top 
level window). 


This request should only be used if the application’s standard window group is currently top of the 
WM stack. 


This API function call is blocking. 


This API is for Top-Level Windows only. Therefore to change focus to a child window within a 
Top-Level window, the GTK Toolkit can be used directly. 
Parameters: 


— appld Application Instance ID. 


— windowID Window ID of the top level window to bring to the foreground. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst attempting to change the input focus. 
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5.3 WM Key Handling APIs 


5.3.1 Detailed Description 


The Window Manager delivers standard key events to an application via XEvents, key events are sent to 
the top-level window of the standard window group which has an application Ul state of Foreground. 


The Window Manager is responsible for ensuring when UI state changes occur (i.e. starting new applica- 
tion, raising/lowering of top-level windows); key reporting is stopped until the UI switch has finished, then 
key reporting is re-started. Key presses can be discarded or preserved during UI application switching. 


The Window Manager also allows applications to register for key hooks, which are reported when the 
application is not in the foreground. 


The Window Manager internally has a table, which provides a mapping between key codes and key symbols 
and defines the long key press settings. This key mapping table can be customised by the specific vendor. 
This table also defines how and when key presses are reported to the application; this functionality can be 
customised by calling the different Window Manager Key APIs. By default, a long key notification will be 
reported for all keys except the navigation (up, down, left and right) keys and the clear key, where a repeat 
key notification will be reported. 


Functions 


e int AppUIWmPollKeyPress (AppInstanceld appld, int bufferSize, char xbuffer) 


Application notifies WM to grab current key presses. 


e int AppUIWmRegisterKeyHook (AppInstanceld appId, AppUIWmKeyID keyID, AppUIWmKey- 
HookType keyhookType, AppUIWmBool exclusivity, unsigned short duration) 


Application registers key hooks (short and long press). 


e int AppUIWmUnregisterKeyHook (AppInstanceld appId, AppUIWmKeyID keyID) 


Application un-registers a specific key hook. 


5.3.2 Function Documentation 
5.3.2.1 int AppUIWmPollKeyPress (AppInstanceld appld, int bufferSize, char x buffer) 


Application notifies WM to grab current key presses. 


The application requests the WM to grab the current key or groups of keys required for quick appli- 
cation response e.g. gaming. 


This API can only be used for an application in the foreground; this is restricted to prevent key 
snooping. 


In order to receive a group of keys the multi-key mode has to have been set, this is set by the vendor. 


Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 


This API function call is blocking. 
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Parameters: 


— appld Application Instance ID. 


— bufferSize Size of buffer: this should be ’+1’ as first element in buffer defines number of keys 
pressed. 


> buffer The contents of the buffer where the first element defines the number of keylds. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst getting the current key or groups of keys. 


5.3.2.2 int AppUIWmRegisterKeyHook (AppInstanceld appId, AppUIWmKeyID keyID, 
AppUIWmKeyHookType keyhookType, AppUIWmbBool exclusivity, unsigned short 
duration) 


Application registers key hooks (short and long press). 


The purpose of this API is to allow an application not in the foreground to be notified when the 
specified key is pressed. 


Applications need to re-register after a key hook has been received unless the key hook registration 
requested exclusivity, in which case the key hook registration is persistent until it is unregistered. 


The number of key hooks allowed to be registered is subject to the SPEF policy. Availability of 
exclusive key hooks is subject to the SPEF policy. 


Only four applications are allowed to register for the same key hook, any subsequent attempts to 
register for the key hook will be rejected (error reason of APPUI WM KEYHOOK ALREADY - 
USED is specified). 


When the application receives a Key Event from the Window Manager, the application can determine 
the key type (normal or hook) by examining the state member. 


Where a request for an exclusive key hook registration is made, it will be rejected if another appli- 
cation already has the same key hook registered. A key hook registration request for a key hook that 
has already been exclusively registered by another application will be rejected. An error reason of 
APPUL WM_KEYHOOK_ALREADY_USED will be specified in both cases. 


Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 


This API function call is blocking. 


Parameters: 


— appld Application Instance ID. 
— keyID The key ID to register the hook for. 


— keyhookType Identify the type of hook: 
APPUI WM KEYHOOK SHORT 
APPUI WM KEYHOOK LONG. 


— exclusivity Whether the key hook registration request is for exclusive access (APPUL_WM_TRUE) 
or not (APPUI_WM_FALSE). 


— duration Duration of press and hold notification, default is 0=100ms, max value is 255. 
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Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst registering the key hook with the Window Man- 
ager. 


5.3.2.3 int AppUIWmUnregister KeyHook (AppInstanceld appId, AppUIWmKeyID keyID) 


Application un-registers a specific key hook. 


+ This API un-registers the specified key hook. 


e The application will no longer be notified when the key is pressed. 


e Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 
+ This API function call is blocking. 


Parameters: 


— appld Application Instance ID. 
— keyID The key ID to un-register. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst un-registering the key hook with the Window 
Manager. 
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5.4 WM Event Registration APIs 


Functions 


e int AppUIWmkRegisterForEvent (AppInstanceld appld, AppUIWmEventID evID, AppUIWmIn- 
putEventCallbackFunc callbackName) 


Register an application to receive window manager input events. 


+ int AppUIWmUnregisterForEvent (AppInstanceld appld, AppUIWmEventID evID) 


Cancel registration with WM in order not to be notified for input events. 


5.4.1 Function Documentation 


5.4.1.1 int AppUIWmRegisterForEvent (AppInstanceld appId, AppUIWmEventID evID, 
AppUIWmInputEventCallbackFunc callbackName) 


Register an application to receive window manager input events. 


+ Application sending a registration request must include: 


— AppUIWmEventID describing event that the application wants to receive. 


— Callback function that window manager will use to notify the application of the event when it 
occurs. 


+ This API function call is blocking. 


e Applications need to have registered with window manager before calling this API otherwise it re- 
turns parameter error. 


Message Sequence Diagram: 


Event Registration With A Normal End: 
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Figure 5.1: Event Registration With A Normal End 
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Parameters: 


— appld Application Instance ID. 
< evID Type of event. 


— callbackName Callback function information. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: parameter error 


5.4.1.2 int AppUIWmUnregisterForEvent (AppInstanceld appId, AppUIWmEventID evID) 


Cancel registration with WM in order not to be notified for input events. 


+ Application un-registering from an event must include: 


— AppUIWmEventID describing event that the application no longer wants to receive. 


+ This API function call is blocking. 


e Applications requesting to cancel an event that it has not registered for will return parameter error. 


Parameters: 


— appld Application Instance ID. 
< evID Type of event. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: parameter error 
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5.5 Foundation APIs - GTK Interaction with Window Manager 


5.5.1 Detailed Description 


Applications, when using GTK based widgets, should be aware that many requests (i.e. MapRe- 
quest/UnMapRequest etc) will be re-directed to the Window Manager and will be subject to Conflict man- 
agement enforcement. The Window Manager will only process requests related to top-level windows, these 
will be forwarded to the XServer once they have been successfully validated. 


The LiMo GTK will automatically call a number of Window Manager APIs, this section details which 
APIs will be called internally as part of LiMo GTK. 


(Note: If the vendor chooses not to use the LiMo GTK, they must explicitly use these APIs). 


Modules 


e WM Registration APIs 
+ WM Window APIs 

e WM Key Settings APIs 
e WM Screen APIs 
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5.6 


WM Registration APIs 


Functions 


int AppUIWmRegisterApplication (AppInstanceld appId, AppUIWmUIStateCallBackFunc uiCall- 
BackFunc, AppUIWmCmEventCallBackFunc emCallBackFunc) 


Registers an application with the WM. 


int AppUIWmUnregisterApplication (AppInstanceld appId) 


Unregisters an application with the WM. 


int AppUIWmSetAppProperties (AppInstanceld appld, AppUIWmAppProperties appProperties) 


Sets application properties to override WM defaults. 


5.6.1 Function Documentation 


5.6.1.1 int AppUIWmRegisterApplication (AppInstanceld appId, AppUIWmUIStateCallBackFunc 


uiCallBackFunc, AppUIWmCmEventCallBackFunc cmCallBackFunc) 


Registers an application with the WM. 


This API is used to register an application instance with the WM so that an application can use its services. 


An application cannot use other WM APIs until registered. 
The application sends a registration request to the WM. 
The WM validates the App ID by querying the Application Launcher. 


A UI State Change Call back function is registered. The call back occurs every time the UI State 
changes. When the UI State Change is set to Foreground the application starts to receive key events. 


A Case Movement Event Call back function is registered. The call back occurs whenever the Window 
Manager is informed when a case movement occurs. 


By default the WM will clear the key buffer when the application comes to the Foreground. 


The Window Manger sets the following application properties as default: 
precedence = APPUI_WM_PRECEDENCE_NORMAL, 
key buffer policy = APPUI WM KEY BUFFER DISCARD. 


After registration the application can customise the WM behaviour by calling the AppUIWmSetApp- 
Properties() API. 


This API function call is blocking. 
Once registered the application is now ready to use the Window Manager APIs. 


Pre-requisite: The application has not registered with the Window Manager 
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Message Sequence Diagram: 


Application Start-Up: 
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Figure 5.2: Application Start-Up 


Parameters: 


— appld Application Instance ID. 

—uiCallBackFunc Registration of callback for when the application UI State. 

+ cmCallBackFunc Registration of callback for when the Window Manager will inform application 
about a case movement. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst registering the application with the Window 
Manager. 


5.6.1.2 int AppUIWmSetAppProperties (AppInstanceld appId, AppUIWmAppProperties 
appProperties) 


Sets application properties to override WM defaults. 


This optional API allows the application to customise the WM behaviour: 


e Standard Window Group Precedence. 


The parameter informs the Window Manager to change the initial position of the application's stan- 
dard window group in the WM Stack. By default, WM will place standard window groups at the 
bottom of the stack. With high precedence the standard window group will be placed above the 
default application. 


+ Key Buffer clear policy. 


Used to update the current buffer clear policy. Default behaviour is that the keys stored in the buffer 
will not be preserved when the application UI State changes to the Foreground. 
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e The Window Manager will only allow the precedence setting to be modified before the application 


has registered any top-level windows. If an application attempts to change its precedence setting 
after registering a top-level window, the Window Manager will reject the request with a APPUI - 
WM_INVALID_SEQUENCE error reason. 


+ This API function call is blocking. 


e Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 


Usage: 


Register the application with the Window Manager and then set the application override paramters: 


returnCode = AppUIWmRegisterApplication (appInstancelD, 
WmUIStateCallbackFunc, 
WmCMStateCallbackFunc) ; 


appProperties.appPrecedence 
appProperties.keyBufferPolicy 


APPUI_WM_PRECEDENCE_HIGH; 
APPUI_WM_KEY_BUFFER_KEEP; 


oll 


returnCode = AppUIWmSetAppProperties (appInstancelID, 
appProperties) ; 


Parameters: 


— appld Application Instance ID. 


— appProperties Provides a structure containing custom parameters including: 


AppUIWmPrecedence - Determines the priority order where the standard window group should 
reside in the WM Stack. 


AppUIWmKeyBufferPolicy - Determines how the Window Manager handles buffered key 
presses. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst settings the application properties. 


5.6.1.3 int AppUIWmUnregisterApplication (AppInstanceld appId) 


Unregisters an application with the WM. 


This API is used to un-register an application instance with the WM. Calling this API means that the WM 
no longer handles the applications top-level windows. 


The application un-registers itself with the WM. 
All call backs and key events are stopped. 
The Window Manager will not allow the application’s Top-Level windows to be displayed. 


It is the responsibility of the application to destroy it’s windows. 


This API function call is blocking. 
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Message Sequence Diagram: 


Application Shutdown: 
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Figure 5.3: Application Shutdown 


Parameters: 


< appld Application Instance ID. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst un-registering the application. 
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5.7 WM Window APIs 


5.71 Detailed Description 


The Window Manager manages application's top-level windows which are grouped together within a stan- 
dard window group. Each application through its standard window group has an associated UI state; this 
can be used by applications for managing their UI resources. The Window Manager also manages inter 
application window groups, where two or more application’s standard windows groups are interrelated. 


Applications use the Window Manager by either directly manipulating their windows calling Window 
Manager API, or indirectly through calling GTK APIs. The Window Manager is responsible for ensuring 
when UI state changes occur, the screen is locked to prevent screen flicker, when the UI switch has finished 
the screen lock is removed and thus allows any updates to be made. 


Applications wishing to change windows and their properties (i.e. focus) within their top-level windows 
should use APIs within the GTK toolkit. 


For further details on standard window and inter application window groups see LiMo HLA Window 
Hierarchy section. 
Functions 


e int AppUIWmRegisterTopLevelWin (AppInstanceld appId, AppUIWindowld windowID) 


Registers a Top-Level Window with the window manager. 


int AppUIWmUnregisterTopLevelWin (AppInstanceld appId, AppUIWindowId windowID) 


Un-registers a Top-Level Window with the Window Manager. 


int AppUIWmRaiseApplicationGrp (AppInstanceld clientAppld, AppInstanceld targetAppld) 


Reguests WM to raise the application's windows to the foreground. 


int AppUIWmLowerApplicationGrp (AppInstanceld appId) 


Reguests WM to lower the application's windows. 


int AppUIWmSetWindowGrpPosition (AppInstanceld clientAppld, AppUIWmWinGrpPos posi- 
tion) 


Reguests WM to change the position of the standard window group within an inter application window 
group. 


5.7.2 Function Documentation 
5.7.2.1 int AppUIWmLowerApplicationGrp (AppInstanceld appId) 


Requests WM to lower the application’s windows. 


e Application sends request to WM to lower it’s windows to the bottom of the WM stack, subject to 
the Precedence property. If the application’s standard window group is part of an inter application 
window group, then this API will operate to lower the entire inter application window group. If 
not part of an inter application window group, then the API will operate to lower the application’s 
standard window group. 
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Where the API operates on an inter application group, of which the requesting application’s standard 
window group is a part, then all standard window groups in the inter application window group will 
also be lowered. The order of standard window groups within the inter application window group 
will be preserved. If the API operates on a standard window group then the requesting application’s 
standard window group will be lowered. 


(see LiMo HLA Window Manager section for more information on inter application groups, standard 
window groups and UI states). 


If the lowering of either an inter application window group or a standard window group causes a 
change to any application UI state, then the Window Manager shall check with the conflict man- 
ager and if the change is permitted, manage the necessary application transitions before the lower 
operation is performed. 


Specifically, where a standard window group with UI state of foreground is lowered, the Window 
Manager will do the following before performing the lower operation. 


— The WM will inform the Conflict Manager that the application is no longer in the Foreground. 
The WM will check with Conflict Manager to determine if the next application on WM stack 
can access the screen. If it can not access the screen then the lower request will be cancelled. 


— The application switching lock is applied and key reporting is stopped. 


— The application with a UI state of foreground will receive a UI State callback notification to 
inform its Ul state has changed. 


— The WM will restart key reporting to the new foreground application and release the application 
switching lock. 


— If the standard window group is part of an inter application window group, then the associated 
inter application window group are also lowered. 


e Applications need to have registered (AppUIWmRegisterApplication()) and have created one top- 
level window (AppUIWmRegisterTopLevelWin()) before calling this API. 


+ This API function call is blocking. 


Parameters: 


— appld Application Instance ID. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst attempting to lower the window group. 


5.7.2.2 int AppUIWmRaiseApplicationGrp (AppInstanceld clientAppId, AppInstanceld 
targetAppld) 


Requests WM to raise the application’s windows to the foreground. 


+ Application sends request to WM to raise its windows to the foreground. If the application”s standard 
window group is part of an inter application window group, then this API will operate to raise the 
entire inter application window group. If not part of an inter application window group, then the API 
will operate to raise the application’s standard window group. 


(see LiMo HLA Window Manager section for more information on inter application groups, standard 
window groups and UI states). 
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WM will check with the Conflict Manager component to determine if the application is able to get 
access to the screen. 


If the Conflict Manager permits the raise request, the WM applies the application switch lock (screen 
lock and key lock). The WM will then stop key reporting to the current foreground application. 


If the application makes a request whilst the application switching lock is enabled, this is buffered un- 
til the lock is released. The application switch lock prevents screen flicker during UI state transitions 
and key loss. 


The current foreground application will then receive a UI State callback notification to inform its UI 
state has changed to background. 


Where the API operates on the inter application window group then the application whose standard 
window group is at the top of the inter application window group will then receive an UI State 
callback notification. This notification shall inform the application that its UI state has changed to 
the foreground. Where the API operates solely on the application’s standard window group, then the 
requesting application shall receive the notification. 


The application with a UI state of foreground will then have its standard window group raised to the 
foreground. The WM will assign input focus to the top-level window that is highest in the display 
stack and on the main screen. 


If the application’s standard window group is part of an inter application window group, then the 
other standard window groups in the inter application window group will also be raised in the WM 
stack at the same time. The order of standard window groups within the inter application window 
group will be preserved. 


The WM will restart key reporting to the new foreground application and release the application 
switching lock. 


If the application’s standard window group is not top of the inter application window group, it can 
use the AppUIWmSetWindowGrpPosition() API to move it to the top. 


Applications can use the AppUIWmReguestInputFocus() API to alter which top-level window 
should receive the focus within their standard window group. 


Alternatively, an application may specify another application’s instance id when using this API. This 
will allow another application to raise an application’s windows, subject to the behaviour described. 
This functionality is protected and the API will check the vendor SPEF policy to see if the application 
has the necessary privileges for this operation. 


Applications need to have registered (AppUIWmRegisterApplication()) and have created one top- 
level window (AppUIWmRegisterTopLevelWin()) before calling this API. 


This API function call is blocking. 


Message Sequence Diagram: 


Application UI Transition: 
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Figure 5.4: Application UI Transition 


Parameters: 

— clientAppld Application Instance ID of requesting application. 

— targetAppld Application Instance ID of application whose windows should be raised. 
Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst attempting to raise the window group to the fore- 
ground. 


5.7.2.3 int AppUIWmkRegisterTopLevelWin (AppInstanceld appId, AppUIWindowId windowID) 
Registers a Top-Level Window with the window manager. 


e Only Top-Level Windows registered with the Window Manager will be eligible for display on the 
screen (mapped), this is subject to WM Stack order and conflict management. 


e When the application is moved to the Foreground, the application will start receiving key events from 
the Window Manager. 
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The first Top-Level Window registered by an application forms the application’s standard window 
group. If the application is associated with another application then the standard window group will 
be placed at the top of an inter application window group containing the other application’s standard 
window group. If the application is not associated with another application then it will be placed at 
the bottom of the Window Manager stack, subject to the application precedence property. 


If an application attempts to map (show) it’s top-level window without having first registered it with 
the Window Manager, then the request will be rejected. 


Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 
Application creates a Top-Level Window using gtk_window_new(). 
Application calls gtk_widget_realize() in order to create the WindowID. 


Applications must ensure they call this API before attempting to show the window through the widget 
set, otherwise the Window Manager will reject the resulting request to map the window. 


This API function call is blocking. 


Message Sequence Diagram: 


Application Creates Top Level Window: 
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Figure 5.5: Application Creates Top Level Window 


Parameters: 


— appld Application Instance ID. 
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— windowID X window ID of the newly created top level window. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst registering the top level window with the Window 
Manager. 


5.7.2.4 int AppUIWmSetWindowGrpPosition (AppInstanceld clientAppId, AppUIWmWinGrpPos 
position) 


Requests WM to change the position of the standard window group within an inter application window 
group. 


This API can only be used by an application whose standard window group is part of an inter appli- 
cation window group. If the application’s standard window group is not part of an inter application 
window group no action will be performed. 


An application can request the Window Manager to change the position of its standard window group 
within the inter application window group. The standard window group can be placed at either the 
bottom or the top of the inter application window group. 


If the request is to be placed at the top of the inter application window group and the inter application 
window group is already at the top of the WM stack, then the WM will check with the Conflict 
Manager component to determine if the application is able to get access to the screen. 


If the change in the standard window group’s position will result in a different standard window 
group gaining or losing input focus then a UI state transition will occur. 


If a UI state transition does occur, this will result in the application switching lock being applied 
(screen lock and key lock) whilst the transition occurs. 


Applications need to have registered (AppUIWmRegisterApplication()) and have created one top- 
level window (AppUIWmRegisterTopLevelWin()) before calling this API. 


This API function call is blocking. 


Parameters: 


— clientAppld Application Instance ID. 


— position Determines where the standard window group should be moved to. 


Returns: 


OPERATION SUCCESS: normal end 
ERR OPERATION, FAILED: Error occurred whilst attempting to move the standard window group. 


5.7.2.5 int AppUIWmUnregisterTopLevelWin (AppInstanceld appId, AppUIWindowlId 
windowID) 


Un-registers a Top-Level Window with the Window Manager. 


+ The Top-Level Window is no longer eligible for display (it is unmapped). 
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+ The application instance will no longer receive key events when the last Top-Level Window is un- 
registered from the standard window group. 


e Applications need to have registered (AppUIWmRegisterApplication()) and have registered one top- 
level window (AppUIWmRegisterTopLevelWin()) before calling this API. 


+ This API function call is blocking. 


Parameters: 


— appld Application Instance ID. 


— windowID X window ID of the top level window to un-register. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst un-registering the top level window. 
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5.8 WM Key Settings APIs 


Functions 


e int AppUIWmChangeLongKeySettings (AppInstanceld appId, AppUIWmKeyID keyID, unsigned 
short repeatInterval, unsigned short duration, AppUIWmKeyPressNotification keyPress, AppUI- 
WmKeyNotificationType keyNotifyType) 


This API changes the way long key presses are reported to the application. 


5.8.1 Function Documentation 


5.8.1.1 int AppUIWmChangeLongKeySettings (AppInstanceld appId, AppUIWmKeyID keyID, 
unsigned short repeatInterval, unsigned short duration, AppUIWmKeyPressNotification 
keyPress, AppUIWmKeyNotificationType keyNotify Type) 


This API changes the way long key presses are reported to the application. 


e Application sends request to WM to update key press and hold notifications. 


+ Applications can choose either to receive a long key press or repeat key notification, by setting the 
keyNotifyType parameter. 


e Applications can define if the notification is during the press or release of the key. 
+ Duration is specified is in units of 100ms. 


e See Standard Key Symbols Table describing default press and hold settings. 


e Applications need to have registered (AppUIWmRegisterApplication()) before calling this API. 


+ This API function call is blocking. 


Usage: 


For press and hold of UP key, notify application after 200ms has expired and repeat standard key 
presses every 400ms: 


duration = 1; 
interval = 3; 
returnCode = AppUIWmChangeLongKeySettings (appld, 
APPUI_WM_KEY_UP, 
interval, 
duration, 
APPUI_WM_KEY_PRESSED, 
APPUI WM KEY REPEAT PRESS); 
Standard Key Symbols: 


The table below contains standard key symbols that can be used within applications: 
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Key Name Event Infor- | Press and Press and Long Key Repeat 
mation:Key hold set- hold Press Time Interval in 
Symbol tings:Long settings:Key | in increments 
(AppUI- Key Press Notification increments of 100msec 
WmKeyID) Trigger Type of 100msec 
Notification 
Sl (soft key) | APPUI - APPUI_- APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
SOFT 1 PRESSED LONG - 
PRESS 
S2 (soft key) | APPUI_- APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
SOFT 2 PRESSED LONG - 
PRESS 
S3 (soft key) | APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM. KEY - | WM KEY - 
SOFT 3 PRESSED LONG - 
PRESS 
S4 (soft key) | APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
SOFT 4 PRESSED LONG - 
PRESS 
S5 (soft key) | APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
SOFT 5 PRESSED LONG - 
PRESS 
Menu APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
MENU PRESSED LONG - 
PRESS 
Side down APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM. KEY - | WM KEY - 
SIDE - PRESSED LONG - 
DOWN PRESS 
Side up APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
SIDE UP PRESSED LONG - 
PRESS 
Up APPUI - APPUI - APPUI - 10 1 
WM. KEY - | WM KEY - | WM.KEY - 
UP RELEASED | REPEAT - 
PRESS 
Down APPUI - APPUI - APPUI - 10 1 
WM KEY - | WM. KEY - | WM KEY - 
DOWN RELEASED | REPEAT - 
PRESS 
Left APPUI - APPUI - APPUI - 10 1 
WM. KEY - | WM KEY - | WM.KEY - 
LEFT RELEASED | REPEAT - 
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Key Name Event Infor- | Press and Press and Long Key Repeat 
mation:Key hold set- hold Press Time Interval in 
Symbol tings:Long settings:Key | in increments 
(AppUI- Key Press Notification increments of 100msec 
WmKeyID) Trigger Type of 100msec 
Notification 
Right APPUI_- APPUI_- APPUI - 10 1 
WM. KEY - | WM KEY - | WM.KEY - 
RIGHT RELEASED | REPEAT - 
PRESS 
Start (Yes) APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
START PRESSED LONG - 
PRESS 
Call-end APPUI - APPUI - APPUI - 20 0 
(No) WM KEY - | WM. KEY - | WM KEY - 
CALL END | PRESSED LONG - 
PRESS 
Clear APPUI - APPUI - APPUI - 10 0 
WM. KEY - | WM KEY - | WM.KEY - 
CLEAR RELEASED | REPEAT - 
PRESS 
Dial 0 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 0 PRESSED LONG - 
PRESS 
Dial 1 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 1 PRESSED LONG - 
PRESS 
Dial 2 APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM. KEY - | WM KEY - 
DIAL 2 PRESSED LONG - 
PRESS 
Dial 3 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 3 PRESSED LONG - 
PRESS 
Dial 4 APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM_KEY - | WM KEY - 
DIAL 4 PRESSED LONG - 
PRESS 
Dial 5 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 5 RELEASED | LONG - 
PRESS 
Dial 6 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 6 PRESSED LONG - 


PRESS 
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Key Name Event Infor- | Press and Press and Long Key Repeat 
mation:Key hold set- hold Press Time Interval in 
Symbol tings:Long settings:Key | in increments 
(AppUI- Key Press Notification increments of 100msec 
WmKeyID) Trigger Type of 100msec 
Notification 
Dial 7 APPUI_- APPUI_- APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 7 PRESSED LONG - 
PRESS 
Dial 8 APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL 8 PRESSED LONG - 
PRESS 
Dial 9 APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM. KEY - | WM KEY - 
DIAL 9 PRESSED LONG - 
PRESS 
Dial « APPUI - APPUI - APPUI - 0 0 
WM. KEY - | WM KEY - | WM.KEY - 
DIAL - PRESSED LONG - 
ASTERISK PRESS 
Dial # APPUI - APPUI - APPUI - 0 0 
WM KEY - | WM. KEY - | WM KEY - 
DIAL - RELEASED | LONG - 
NUMSIGN PRESS 
Function key | APPUI - APPUI_- APPUI - 0 0 
11 WM. KEY - | WM KEY - | WM.KEY - 
F11 PRESSED LONG - 
PRESS 
Function key | APPUI - APPUI - APPUI - 0 0 
12 WM KEY - | WM. KEY - | WM KEY - 
F12 PRESSED LONG - 
PRESS 
Function key | APPUI - APPUI - APPUI - 0 0 
13 WM KEY - | WM. KEY - | WM KEY - 
F13 PRESSED LONG - 
PRESS 
Function key | APPUI - APPUI - APPUI - 0 0 
14 WM KEY - | WM. KEY - | WM KEY - 
F14 PRESSED LONG - 
PRESS 
Function key | APPUI - APPUI - APPUI - 0 0 
15 WM KEY - | WM. KEY - | WM KEY - 
F15 PRESSED LONG - 
PRESS 
Function key | APPUI_- APPUI_- APPUI - 0 0 
16 WM KEY - | WM KEY - | WM KEY - 
F16 PRESSED LONG - 
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Key Name Event Infor- | Press and Press and Long Key Repeat 
mation:Key hold set- hold Press Time Interval in 
Symbol tings:Long settings:Key | in increments 
(AppUI- Key Press Notification increments of 100msec 
WmKeyID) Trigger Type of 100msec 
Notification 
Function key | APPUI_- APPUI - APPUI - 0 0 
17 WM KEY - | WM. KEY - | WM KEY - 
F17 PRESSED LONG - 
PRESS 
Function key | APPUI - APPUI - APPUI - 0 0 
18 WM KEY - | WM. KEY - | WM KEY - 
F18 PRESSED LONG - 
PRESS 


Parameters: 
— appld Application Instance ID. 
— keyID The key ID to update 


— repeatInterval Determines the interval to repeat the key press, 0 = 100ms, max. 255. For long key 
notification this will always be 0. 


— duration Duration of press and hold notification, default O = 100 ms, max value is 255. 
— keyPress Key press trigger, either when key is pressed or released. 


— keyNotifyType Determines the type of key notification, either long key press or repeat key press. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: Error occurred whilst setting the long key notification. 
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5.9 WM Screen APIs 


Functions 


e int AppUIWmSetAppWinInvisible (AppInstanceld appld, char screenID) 


Application sets its top level windows on specified screen invisible. 


e int AppUIWmSetAppWinVisible (AppInstanceld appld, char screenID) 


Application set its top level windows on the specified screen visible. 


5.9.1 Function Documentation 
5.9.1.1 int AppUIWmSetAppWinInvisible (AppInstanceld appld, char screenID) 


Application sets its top level windows on specified screen invisible. 


This API is used to allow application to choose not to show its top level windows on the specified 
screen by setting them invisible. By default top level windows from an application are raised or 
lowered synchronously across screens, so application can show its top level windows on multiple 
screens simultaneously, but in some special cases, the application may only be required to show its 
top level windows on one or some of the screens, this API is designed to be used for this type of 
special cases. 


When application calls this API, WM set the invisible attribute of top level windows of this applica- 
tion on the specified screen. 


This API function call is blocking. 


By default, the invisible attribute of top level windows are not set, and top level windows from an 
application are raised or lowered synchronously across screens, so application can show its top level 
windows on multiple screens simultaneously. 


In order for top level windows of an application not being shown on the specified screen, application 
should call this API to set the invisible attribute of its top level windows first, then call AppUIWm- 
RaiseApplicationGrp() to raise the standard window group to the top of the WM application stack. 
WM search from the top of stack for the first top level window without invisible attribute, and maps 
it onto screen. 


Message Sequence Diagram: 


Set Invisible: 
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Figure 5.6: Set Invisible 


Parameters: 


— appld Application Instance ID. 
<—screenID The screen ID. 


Returns: 


OPERATION SUCCESS: normal end 

ERR OPERATION FAILED: incorrect parameter 
5.9.1.2 int AppUIWmSetAppWinVisible (AppInstanceld appld, char screenID) 
Application set its top level windows on the specified screen visible. 


+ This API is used to allow an application to unset the invisible attribute of top-level windows previ- 
ously set through AppUIWmSetAppWinInvisible(). By default top-level windows from an applica- 
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tion are raised or lowered synchronously across screens and shown on multiple screens simultane- 
ously. The invisible attribute of top-level windows is not set by default, and it is only set when ap- 
plication call AppUIWmSetAppWinlnvisible() explicitly to disable top level windows being shown 
only on some of the screens. 


When an application calls this API, the WM changes the invisible attribute of top-level windows of 
this application on the specified screen. 


This API function call is blocking. 


This API only needs to be used if AppUIWmSetAppWinlnvisible() is called previously. 


After the invisible attribute is set by calling AppUIWmSetAppWinlnvisible(), top level windows of 
the application are not shown on some screens. Application needs to call this API when it wants to 
resume the normal behavior. After unset the invisible attribute, WM maps top level window of the 
application onto multiple screens simultaneously after AppUIWmRaiseApplicationGrp() is called. 


Parameters: 


— appld Application Instance ID. 


— screenID The screen ID. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: incorrect parameter 
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5.10 Framework APIs 


Modules 


+ Key Adapter interfaces 
e Input Plug-in interfaces 
e Case Movement Plug-in interfaces 
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5.11 Key Adapter interfaces 
Functions 


+ void AppUIWmKeyReceived (AppUIWmKeyInfo *keyInfo) 


API on the Window Manager Key component used by Key adapter to deliver key events. 


e int AppUIWmAdapterlnitialise (void) 


Initialises key adapter. 


+ void AppUIWmAdapterRun (void) 


Read key events from the LiMo vendor’s key driver and report them to the Window manager key component. 


5.11.1 Function Documentation 
5.11.1.1 int AppUIWmAdapterInitialise (void) 


Initialises key adapter. 


This API will initialise the LiMo vendor’s key adapter and its device driver(s). 


It is the responsibility of the LiMo vendor to add any logic required to put their device driver(s) into 
a state of readiness to report key events. 


It should be noted that key events should not be reported until after the AppUIWmAdapterRun() API 
is called. 


If an error occurs while initialising the LiMo vendor’s device drivers, this API should return ERR_- 
OPERATION_FAILED. 


If the LiMo vendor’s device drivers have successfully initialised, this API should return 
OPERATION_SUCCESS. 


This API will be called inside the Key adapter thread that is created during WM start up. 


Message Sequence Diagram: 


Key Adapter Start-up And Key Reporting: 
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Figure 5.7: Key Adapter Start-up And Key Reporting 


Returns: 


OPERATION_SUCCESS: LiMo vendor’s device drivers have been successfully initialised 
ERR_OPERATION_FAILED: An error occurred while initialising the LiMo vendor’s device drivers. 


5.11.1.2 void AppUIWmAdapterRun (void) 


Read key events from the LiMo vendor's key driver and report them to the Window manager key compo- 
nent. 


+ This API shall repeatedly read events from the LiMo vendors driver and then send them onto the 
window manager key component via the AppUIWmKeyReceived() API. 


e The body of this API holds a loop that the LiMo vendor should add logic to do the following steps: 


— Poll on the Key device driver for a key event. 


— When a key event is available from the driver, populate the AppUIWmKeylnfo structure with 
the key code and type. 


— Report the key event to the Key component via a call to the AppUIWmKeyReceived() API, 
providing the AppUIWmKeyInfo structure. 


+ The loop shall periodically check the AppUIWmKey AdapterStopFlag to see if Window manager has 
requested the Key adapter to stop. 


+ The loop shall continue to run until either of the following conditions occur: 
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— An error occurs when reading key events from the LiMo vendor’s device driver. 


— The API checks the AppUIWmKeyAdapterStopFlag and finds that it is set to APPUI WM - 
TRUE (indicating that the WM has requested key adapter stop reporting events). 


It is possible that a key event be sent to the WM Key component between the WM requesting the 
adapter to stop and this API checking the App UIWmKey AdapterStopFlag flag. 


When this API ends it shall ensure that the vendor’s driver can be used if the Key adapter is restarted. 


The Key adapter thread will call this API after it has initialised the Key adapter and its key driver. 


Please refer to the Key Adapter Start-up And Key Reporting Message Sequence Diagram for further 
information. 


5.11.1.3 void AppUIWmKeyReceived (AppUIWmKeyInfo + keyInfo) 


API on the Window Manager Key component used by Key adapter to deliver key events. 


+ The Key adapter will use this API to send key events to the window manager key component. 


e For each Key event, the Key adapter shall populate the AppUIWmKeylnfo structure supplying in- 
formation about the type of event (press/release) and the key codes relating to the event. 


+ Please refer to the Key Adapter Start-up And Key Reporting Message Sequence Diagram for further 
information. 


Parameters: 


keyInfo Key information. 
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5.12 Input Plug-in interfaces 


Functions 


+ void AppUIWmPluginEventNotify (AppUIWmEventID evID, AppUIWmPluginData data) 


Event notification from the input plug-in. 


+ int AppUIWmStartEventPlugin (void) 


Reguest to initialise and start sending input plug-in events. 


e int AppUIWmStopEventPlugin (void) 


Reguest that input plug-in stop sending events. 


5.12.1 Function Documentation 


5.12.1.1 void AppUIWmPluginEventNotify (AppUIWmEventID evID, AppUIWmPluginData 
data) 


Event notification from the input plug-in. 


Each LiMo member’s input plug-in uses this API to notify the window manager that an event has been 
received. 


e AppUIWmEventID is the unique identifier of the event occurring. 
+ Data is any data relating to the event occurring. 


+ Please refer to the Event Registration With A Normal End Message Sequence Diagram for further 
information. 


NOTE: The ’data’ is mandatory. If an event does not include additional data, The 'length' data member 
shall be set to 0. 


Parameters: 
< evID Type of event. 


— data Input plug-in additional information. 


5.12.1.2 int AppUIWmStartEventPlugin (void) 


Request to initialise and start sending input plug-in events. 


Each LiMo input plug-in will need to implement this function. 


e Window manager will then call this API to request input plug-in to start sending events to the window 
manager. 


e Any input plug-in start-up logic should be included in the implementation of this function. 
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Message Sequence Diagram: 


Input Plug-in Mechanism Start-Up: 
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Figure 5.8: Input Plug-in Mechanism Start-Up 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: error starting input plug-in 


5.12.1.3 int AppUIWmStopEventPlugin (void) 


Request that input plug-in stop sending events. 


Each LiMo input plug-in will need to implement this function. 


+ The window manager will call this API to request input plug-in to stop sending events to the window 
manager 


+ Any input plug-in stop logic should be included in the implementation of this function. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: error stopping input plug-in 
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5.13 Case Movement Plug-in interfaces 


Functions 


+ void AppUIWmCaseMvmtEventNotify (AppUICaseMovementEvent evID) 


Event notification from the case movement plug-in. 


e int AppUIWmStartCaseMvmtPlugin (void) 


Request the case movement plug-in to initialise and start sending events. 


e int AppUIWmStopCaseMvmtPlugin (void) 


Request the case movement plug-in to stop sending events. 


5.13.1 Function Documentation 
5.13.1.1 void AppUIWmCaseMvmtE ventNotify (AppUICaseMovementEvent evID) 


Event notification from the case movement plug-in. 


Each vendor’s case movement plug-in uses this API to notify the window manager that a case movement 
event has been received. 


Parameters: 


< evID The unique identifier of the event occurring. 


5.13.1.2 int AppUIWmStartCaseMvmtPlugin (void) 


Request the case movement plug-in to initialise and start sending events. 


Each LiMo case movement plug-in will need to implement this function. 


e Window manager will call this API to request the case movement plug-in to start sending events to 
the window manager. 


e Any case movement plug-in start-up logic should be included in the implementation of this function. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: error starting input plug-in 


5.13.1.3 int AppUIWmStopCaseMvmtPlugin (void) 


Request the case movement plug-in to stop sending events. 


Each LiMo input plug-in will need to implement this function. 


e The window manager calls this API to request the case movement plug-in to stop sending case 
movement events to the window manager. 
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+ Any case movement plug-in stop logic should be included in the implementation of this function. 


Returns: 


OPERATION_SUCCESS: normal end 
ERR_OPERATION_FAILED: error stopping input plug-in 
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Chapter 6 


Data Structure Documentation 


6.1 AppUIWmAppProperties Struct Reference 


#include <limoWmTypes.h> 


6.1.1 Detailed Description 


Details the application custom parameters. 


Data Fields 


e AppUIWmPrecedence appPrecedence 
+ AppUIWmKeyBufferPolicy keyBufferPolicy 


6.1.2 Field Documentation 

6.1.2.1 AppUIWmPrecedence AppUIWmAppProperties::appPrecedence 
6.1.2.2 AppUIWmKeyBufferPolicy AppUIWmAppProperties::keyBufferPolicy 
The documentation for this struct was generated from the following file: 


+ limoWmTypes.h 
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6.2 AppUIWmKeyInfo Struct Reference 


#include <limoWmAdapter.h> 


6.2.1 Detailed Description 


This structure stores the keycode and type of a key event. 


Data Fields 


+ AppUIWmKeyCode keysToReport [APPUI WM. MAX ADAPTER KEYS] 
e unsigned char numKeysReported 
+ AppUIWmKeyPressType keyAction 


6.2.2 Field Documentation 


6.2.2.1  AppUIWmKeyCode AppUIWmkKeylnfo::keysToReport[APPUI_ WM MAX ADAPTER - 
KEYS] 


e Array of key codes reported on the ’push’ or ’release’. 


+ The number of indexes populated shall match the value of numKeysReported. 


6.2.2.2 unsigned char AppUIWmKeyInfo::numKeysReported 


e Number of key codes reported on this event. 


+ The maximum number of key codes that can be reported should be no more than APPUI_WM_- 
MAX ADAPTER KEYS. 


6.2.2.3 AppUIWmKeyPressType AppUIWmKeyInfo::key Action 


e States whether the event was reported on a APPUI WM KEYTYPE PUSH or APPUI WM - 
KEYTYPE RELEASE. 


The documentation for this struct was generated from the following file: 


+ limoWmAdapter.h 
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6.3 AppUIWmPluginData Struct Reference 


#include <limoWmTypes.h> 


6.3.1 Detailed Description 


Input plug-in additional information. 


Data Fields 


e unsigned int length 
e unsigned char data [ ] 


6.3.2 Field Documentation 
6.3.2.1 unsigned int AppUIWmPluginData::length 


Length of data. 


6.3.2.2 unsigned char AppUIWmPluginData::data[ ] 


Array of input plug-in data. 


The documentation for this struct was generated from the following file: 


e limoWmTypes.h 
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Chapter 7 


File Documentation 


7.1 ComponentOverview.h File Reference 


Defines 


+ #define COMPONENT_OVERVIEW_H 


7.1.1 Define Documentation 


7.1.1.1 #define COMPONENT_OVERVIEW_H 
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7.2 limoWmAdapter.h File Reference 


#include "limoWmTypes.h" 


Data Structures 


+ struct AppUIWmKeyInfo 


This structure stores the keycode and type of a key event. 


Defines 


+ #define APPUI WM MAX ADAPTER KEYS 7 


Enumerations 


e enum AppUIWmKeyPressType { APPUI WM KEYTYPE PUSH, APPUI WM KEYTYPE - 
RELEASE | 


Indicates whether a key has been pushed down or released. 


enum AppUIWmKeyCode { 


APPUI WM ADAPTER KEY 1, APPUI WM. ADAPTER KEY 2, APPUI WM. ADAPTER - 
KEY 3, APPUI WM ADAPTER KEY 4, 

APPUI WM ADAPTER KEY 5, APPUI WM. ADAPTER KEY 6, APPUI WM. ADAPTER - 
KEY 7, APPUI WM ADAPTER KEY 8, 

APPUI WM ADAPTER KEY 9, APPUI WM. ADAPTER KEY (0, APPUI WM. ADAPTER - 
KEY ASTERISK, APPUI WM ADAPTER KEY NUMBERSIGN, 

APPUI WM. ADAPTER KEY SI, APPUI WM. ADAPTER KEY $S2, APPUI WM - 
ADAPTER KEY S3, APPUI WM ADAPTER KEY $S4, 

APPUI WM. ADAPTER KEY S5, APPUI WM. ADAPTER KEY ONHOOK, APPUI_WM_- 
ADAPTER KEY CALL, APPUI WM. ADAPTER KEY SIDEUP, 

APPUI WM. ADAPTER KEY SIDEDOWN, APPUI WM ADAPTER KEY MENU, APPUI - 
WM. ADAPTER KEY CLR, APPUI WM. ADAPTER KEY UP, 

APPUI WM. ADAPTER KEY LEFT, APPUI WM ADAPTER KEY DOWN, APPUI_WM_- 
ADAPTER KEY RIGHT, APPUI WM. ADAPTER KEY F11, 

APPUI WM. ADAPTER KEY Fl2, APPUI WM. ADAPTER KEY Fl3, APPUI WM - 
ADAPTER KEY F14, APPUL WM ADAPTER KEY F15, 

APPUI WM. ADAPTER KEY Fl6, APPUI WM ADAPTER KEY Fl7, APPUI WM - 
ADAPTER KEY Fl8] 


Supported keycodes that a LiMo vendor Key adapter can report to the WM Key component via the AppUI- 
WmKeyReceived() function. 


Functions 


+ void AppUIWmKeyReceived (AppUIWmKeyInfo *keyInfo) 


API on the Window Manager Key component used by Key adapter to deliver key events. 
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Variables 


+ AppUIWmBool AppUIWmKeyAdapterStopFlag 
Flag stating whether the Key adapter should stop reporting key events. 


7.2.1 Define Documentation 
7.2.1.1 Hdefine APPULWM MAX ADAPTER KEYS 7 


Maximum number of key codes that can be reported in any one Key adapter App UIWmKeyInfo structure. 


7.2.2 Enumeration Type Documentation 
7.2.2.1 enum AppUIWmKeyCode 


Supported keycodes that a LiMo vendor Key adapter can report to the WM Key component via the AppUI- 
WmKeyReceived() function. 


Vendor should use function key codes APPUI WM ADAPTER KEY Fll to APPUI WM ADAPTER - 
KEY F18 for dedicated handset function keys (e.g. camera, browser or media player function keys). 


Enumerator: 


APPUI WM ADAPTER KEY 1 key 1 on numeric key pad 
APPUI WM ADAPTER KEY 2 key 2 on numeric key pad 
APPUI WM ADAPTER KEY 3 key 3 on numeric key pad 
APPUI WM ADAPTER KEY 4 key 4 on numeric key pad 
APPUI WM ADAPTER KEY 5 key 5 on numeric key pad 
APPUI WM ADAPTER KEY 6 key 6 on numeric key pad 
APPUI WM ADAPTER KEY 7 key 7 on numeric key pad 
APPUI WM ADAPTER KEY 8 key 8 on numeric key pad 
APPUI WM ADAPTER KEY 9 key 9 on numeric key pad 
APPUI WM ADAPTER KEY 0 key 0 on numeric key pad 
APPUI WM ADAPTER KEY ASTERISK Asterisk key on numeric key pad 
APPUI WM ADAPTER KEY NUMBERSIGN Number sign or hash key on numeric key pad 
APPUI WM ADAPTER KEY S1 Soft key 1 

APPUI WM ADAPTER KEY $2 Soft key 2 (vendor should use as "okay" key) 
APPUI WM ADAPTER KEY $3 Soft key 3 

APPUI WM ADAPTER KEY $4 Soft key 4 

APPUI WM ADAPTER KEY $5 Soft key 5 

APPUI WM ADAPTER KEY ONHOOK Hang up phone call key 
APPUI WM ADAPTER KEY CALL Make call (dial) key 


APPUI WM ADAPTER KEY SIDEUP Up key on side of handset (often used for volume or menu 
scrolling) 


APPUI WM ADAPTER KEY SIDEDOWN Down key on side of handset (often used for volume 
or menu scrolling) 
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APPUI WM ADAPTER KEY MENU Dedicated menu key 
APPUI WM ADAPTER KEY CLR Clear key 
APPUI WM ADAPTER KEY UP Up navigation key 
APPUI WM ADAPTER KEY LEFT Left navigation key 
APPUI WM ADAPTER KEY DOWN Down navigation key 
APPUI WM ADAPTER KEY RIGHT Right navigation key 
APPUI WM ADAPTER KEY F11 Vendor function key 11 
APPUI WM ADAPTER KEY F12 Vendor function key 12 
APPUI WM ADAPTER KEY F13 Vendor function key 13 
APPUI WM ADAPTER KEY F14 Vendor function key 14 
APPUI WM ADAPTER KEY F15 Vendor function key 15 
APPUI WM ADAPTER KEY F16 Vendor function key 16 
APPUI WM ADAPTER KEY F17 Vendor function key 17 
APPUI WM ADAPTER KEY F18 Vendor function key 18 


7.2.2.2 enum AppUIWmKeyPressType 


Indicates whether a key has been pushed down or released. 


Enumerator: 


APPUI_WM_KEYTYPE_PUSH Indicates that the key event was generated by driver on pushing 
down of key(s). 


APPUI_WM_KEYTYPE_RELEASE Indicates that the key event was generated by the driver on a 
release of key(s). 


7.2.3 Variable Documentation 
7.2.3.1 AppUIWmBool AppUIWmKeyAdapterStopFlag 


Flag stating whether the Key adapter should stop reporting key events. 


Flag will be set to APPUL_WM_FALSE during key adapter initialisation and set to APPUI WM TRUE 
by WM when Key adapter is to be stopped. 
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7.3 limoWmA dapter Vendor.h File Reference 


#include "limoWmAdapter.h" 


Functions 


e int AppUIWmAdapterlnitialise (void) 


Initialises key adapter. 


+ void AppUIWmAdapterRun (void) 


Read key events from the LiMo vendor’s key driver and report them to the Window manager key component. 
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7.4 


limoWmAPI.h File Reference 


#include "limoWmTypes.h" 


Functions 


int AppUIWmGetCurrentUIState (AppInstanceld appId, AppUIAppUIState *appUIState) 
Get current UI state from the WM. 


AppUIWmErrorReason AppUIWmGetLastErrorReason (Applnstanceld appld, const char 
+xerrorString) 


Reguests further details on the error received from the WM. 


int AppUIWmReguestInputFocus (AppInstanceld appId, AppUIWindowld windowID) 


Reguests WM to bring one of the applications top-level windows to the foreground. 


int AppUIWmOuery Applnstances (AppInstanceld appld, int «size, int ++buffer) 


Oueries WM for a list of application instances. 


int AppUIWmPollKeyPress (AppInstanceld appId, int bufferSize, char xbuffer) 


Application notifies WM to grab current key presses. 


int AppUIWmRegisterKeyHook (Applnstanceld appId, AppUIWmKeyID keyID, AppUIWmKey- 
HookType keyhookType, AppUIWmBool exclusivity, unsigned short duration) 


Application registers key hooks (short and long press). 


int AppUIWmUnregisterKeyHook (AppInstanceld appId, AppUIWmKeyID keyID) 


Application un-registers a specific key hook. 


int AppUIWmkRegisterForEvent (AppInstanceld appld, AppUIWmEventID evID, AppUIWmIn- 
putEventCallbackFunc callbackName) 


Register an application to receive window manager input events. 


int AppUIWmUnregisterForEvent (AppInstanceld appld, AppUIWmEventID evID) 


Cancel registration with WM in order not to be notified for input events. 


int AppUIWmRegisterApplication (AppInstanceld appId, AppUIWmUIStateCallBackFunc uiCall- 
BackFunc, AppUIWmCmEventCallBackFunc emCallBackFunc) 


Registers an application with the WM. 


int AppUIWmUnregisterApplication (AppInstanceld appId) 


Unregisters an application with the WM. 


int AppUIWmSetAppProperties (AppInstanceld appld, AppUIWmAppProperties appProperties) 


Sets application properties to override WM defaults. 


int AppUIWmRegisterTopLevelWin (AppInstanceld appId, AppUIWindowld windowID) 


Registers a Top-Level Window with the window manager. 


int AppUIWmUnregisterTopLevelWin (AppInstanceld appId, AppUIWindowId windowID) 
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Un-registers a Top-Level Window with the Window Manager. 


int AppUIWmRaiseApplicationGrp (AppInstanceld clientAppld, AppInstanceld targetAppld) 


Requests WM to raise the application’s windows to the foreground. 


int AppUIWmLowerApplicationGrp (AppInstanceld appId) 


Requests WM to lower the application’s windows. 


int AppUIWmSetWindowGrpPosition (Applnstanceld clientAppld, AppUIWmWinGrpPos posi- 
tion) 
Reguests WM to change the position of the standard window group within an inter application window 
group. 


int AppUIWmChangeLongKeySettings (AppInstanceld appId, AppUIWmKeyID keyID, unsigned 
short repeatInterval, unsigned short duration, AppUIWmKeyPressNotification keyPress, AppUI- 
WmKeyNotificationType keyNotifyType) 


This API changes the way long key presses are reported to the application. 


int AppUIWmSetAppWinInvisible (AppInstanceld appld, char screenID) 


Application sets its top level windows on specified screen invisible. 


int AppUIWmSetAppWin Visible (AppInstanceld appld, char screenID) 


Application set its top level windows on the specified screen visible. 
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7.5 limoWmCasePlugin.h File Reference 
#include "limoWmTypes.h" 


Functions 


+ void AppUIWmCaseMvmtEventNotify (AppUICaseMovementEvent evID) 


Event notification from the case movement plug-in. 
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7.6 limoWmCasePluginVendor.h File Reference 


#include "limoWmCasePlugin.h" 


Functions 


+ int AppUIWmStartCaseMvmtPlugin (void) 


Request the case movement plug-in to initialise and start sending events. 


e int AppUIWmStopCaseMvmtPlugin (void) 


Request the case movement plug-in to stop sending events. 
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7.7 limoWmInputPlugin.h File Reference 


#include "limoWmTypes.h" 


Functions 


+ void AppUIWmPluginEventNotify (AppUIWmEventID evID, AppUIWmPluginData data) 


Event notification from the input plug-in. 
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7.8 limoWmInputPluginVendor.h File Reference 


#include "limoWmInputPlugin.h" 


Functions 


e int AppUIWmStartEventPlugin (void) 


Request to initialise and start sending input plug-in events. 


e int AppUIWmStopEventPlugin (void) 


Request that input plug-in stop sending events. 
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7.9 


limoWmTypes.h File Reference 


Data Structures 


struct AppUIWmPluginData 


Input plug-in additional information. 


struct AppUIWmAppProperties 


Details the application custom parameters. 


Typedefs 


typedef unsigned int AppUIWindowld 

typedef void(+ AppUIWmUIStateCallBackFunc )(AppUIAppUIState fromState, AppUIAppUIState 
toState) 

typedef void(+ AppUIWmCmEventCallBackFunc )(AppUICaseMovementEvent cmEventID) 
typedef void(+ AppUIWmInputEventCallbackFunc )(AppUIWmEventID evID, AppUIWmPlugin- 
Data data) 


Enumerations 


enum AppUIWmWinGrpPos { APPUI WM. GRP BOTTOM, APPUI WM. GRP TOP } 


This enumeration is used to indicate the position where the application's standard window group will be 
moved to. 


enum AppUIWmKeyHookType { APPUI WM KEYHOOK SHORT, APPUI WM. KEYHOOK - 
LONG } 


This enumeration issued to indicate the different key hook types. 


enum AppUIWmkKeyPressNotification { APPUI WM KEY RELEASED, APPUI WM. KEY - 
PRESSED | 


This enumeration is issued to indicate when the key notification should happen. 


enum AppUIWmKeyNotificationType { APPUI WM. KEY LONG PRESS, APPUI WM. KEY - 
REPEAT PRESS į 


This enumeration is used to indicate the type of keypress notification. 


enum AppUIWmErrorReason { 


APPUI WM. ILLEGAL PARAMETER, APPUI WM SECURITY FAILURE, APPUI_WM_- 
CONFLICT ERROR, APPUI WM REOUEST REJECTED, 


APPUI WM. INTERNAL ERROR, APPUI WM INVALID SEOUENCE, APPUI WM - 
KEYHOOK ALREADY USED, APPUI WM. NO ERROR } 


This enumeration is used to indicate the different error reasons why an API has failed. 


enum AppUIWmKeyBufferPolicy [ APPUI WM KEY BUFFER DISCARD, APPUI_WM_- 
KEY BUFFER KEBP į 


This enumeration is used to indicate how the Window Manager should handle the key buffer when key 
reporting is stopped. 
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7.9.1 


enum AppUIWmPrecedence { APPUI WM. PRECEDENCE NORMAL, APPUI_WM_- 
PRECEDENCE_HIGH } 


This enumeration is used to indicate where newly registered applications are placed in the WM Stack. 


enum AppUIAppUIState { APPUI WM STATE NULL, APPUI_WM_STATE_INVISIBLE, 
APPUI WM. STATE BACKGROUND, APPUI WM. STATE FOREGROUND | 


This enumeration is used to indicate the application's current UI state. 


enum AppUIWmKeyID { 


APPUI WM. KEY SOFT I, APPUI WM. KEY SOFT 2, APPUI WM. KEY SOFT 3, 
APPUI WM. KEY SOFT 4, 


APPUI WM KEY SOFT 5, APPUI WM KEY MENU, APPUI WM. KEY SIDE DOWN, 
APPUI WM. KEY SIDE UP, 


APPUI WM. KEY UP, APPUI WM. KEY DOWN, APPUI WM. KEY LEFT, APPUI_WM_- 


Zi 


KEY RIGHT, 

APPUI WM KEY START,  APPUI WM. KEY CALL END,  APPUI WM KEY CLEAR, 
APPUI WM. KEY DIAL 0, 

APPUI WM. KEY DIAL I, APPUI WM. KEY DIAL 2, APPUI WM. KEY DIAL 3, 
APPUI WM. KEY DIAL 4, 

APPUI WM. KEY DIAL 5, APPUI WM. KEY DIAL 6, APPUI WM. KEY DIAL 7, 
APPUI WM. KEY DIAL 8, 

APPUI WM. KEY DIAL 9, APPUI WM. KEY DIAL ASTERISK, APPUI WM. KEY - 


DIAL NUMSIGN, APPUI WM. KEY Fl1l, 

APPUI WM. KEY F12, APPUI WM. KEY FIl3, APPUI WM. KEY F14, APPUI WM. KEY - 
FIS, 
APPUI WM. KEY Fl6, APPUL WM. KEY F17, APPUL WM. KEY Fl8] 

enum AppUIWmEventID { APPUI WM LCD ROTATE į 

enum AppUICaseMovementEvent { APPUI WM. FLIP OPEN, APPUI WM. FLIP CLOSE, 
APPUI WM. SLIDER OPEN, APPUI WM. SLIDER CLOSE } 


This enumeration is used to indicate the case movement event. 


enum AppUIWmBool { APPUI WM. FALSE, APPUI_WM_TRUE } 


Typedef Documentation 


7.9.1.1 typedef unsigned int AppUIWindowlId 


7.9.1.2 typedef void(+ AppUIWmCmEventCallBackFunc)(AppUI CaseMovementEvent 


cmEventID) 


Defines an application callback function which is used to notify the application of case movement events. 


7.9.1.3 typedef void(+ AppUIWmInputEventCallbackFunc)(AppUIWmEventID evID, 


AppUIWmPluginData data) 


Defines an application callback function which is used to notify the application when an input plug-in event 
occurs. 
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7.9.1.4 typedef void(+ AppUIWmUIStateCallBackFunc)(AppUIAppUIState fromState, 
AppUIAppUIState toState) 


Defines an application callback function which is used to notify the application of changes to its UI state. 


7.9.2 Enumeration Type Documentation 
7.9.2.1 enum AppUIAppUIState 


This enumeration is used to indicate the application’s current UI state. 


Enumerator: 


APPUI_WM_STATE_NULL Indicates application initial UI state 


APPUI_WM_STATE_INVISIBLE Indicates the standard window group is invisible, this is useful 
so an application can release UI resources 


APPUI_WM_STATE_BACKGROUND Indicates the standard window group is not receiving focus, 
but some part of one of its top-level windows is visible. 


APPUI_WM_STATE_FOREGROUND Indicates the standard window group is in the foreground 
and one of its top-level windows is receiving input focus. 


7.9.2.2 enum AppUICaseMovementEvent 


This enumeration is used to indicate the case movement event. 


This event is what the Window Manager wishes to inform an application about. 


Enumerator: 
APPUI_WM_FLIP_OPEN Clamshell flip open. 
APPUI_WM_FLIP_CLOSE Clamshell flip close. 
APPUI_WM_SLIDER_OPEN Slider open. 
APPUI_WM_SLIDER_CLOSE Slider close. 


7.9.2.3 enum AppUIWmBool 


Enumerator: 
APPUI_WM_FALSE False condition. 
APPUI_WM_TRUE True condition. 


7.9.2.4 enum AppUIWmErrorReason 


This enumeration is used to indicate the different error reasons why an API has failed. 


Enumerator: 


APPUI_WM_ILLEGAL_PARAMETER Indicates the failure was due to an invalid parameter. 
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APPUI_WM_SECURITY_FAILURE Indicates the failure was due to a security failure. 
APPUI_WM_CONFLICT_ERROR Indicates the failure was due to conflict management. 
APPUI WM REOUEST REJECTED Indicates the request was rejected. 
APPUI_WM_INTERNAL_ERROR Indicates an internal programming error. 
APPUI_WM_INVALID_SEQUENCE Indicates the request has been made in the incorrect order 


APPUI WM KEYHOOK ALREADY USED Indicates that the requested key hook registration re- 
guest can not be fulfilled as the key hook is already assigned to applications. 


APPUI WM NO ERROR Indicates no error has been set. 


7.9.2.5 enum AppUIWmEventID 
Vendors may create additional events as needed for specific situations. 


Enumerator: 


APPUI_WM_LCD_ROTATE Used by a handset with a complex hinge to indicate that the hinge has 
been move to a new position. 


7.9.2.6 enum AppUIWmKeyBufferPolicy 


This enumeration is used to indicate how the Window Manager should handle the key buffer when key 
reporting is stopped. 


Enumerator: 


APPUI_WM_KEY_BUFFER_DISCARD Indicates the Window Manager should discard any keys 
in buffer when key reporting is started. This is the default buffer policy. 


APPUI_WM_KEY_BUFFER_KEEP Indicates the Window Manager should send any keys in 
buffer when key reporting is started. 


7.9.2.7 enum AppUIWmKeyHookType 


This enumeration issued to indicate the different key hook types. 


Enumerator: 


APPUI_WM_KEYHOOK_SHORT Indicates key hook is for short key press. 
APPUI_WM_KEYHOOK_LONG Indicates key hook is for long key press. 


7.9.2.8 enum AppUIWmKeyID 


Enumerator: 
APPUI_WM_KEY_SOFT_1 'Softkey 1’ key 
APPUI WM KEY SOFT 2 ’Softkey 2’ key 
APPUI WM. KEY SOFT 3 ’Softkey 3’ key 
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APPUI_WM_KEY_SOFT_4 'Softkey 4 key 
APPUI WM KEY SOFT 5 'Softkey 5’ key 
APPUI WM KEY MENU "Display Menw’ key 
APPUI WM KEY SIDE DOWN 'Display Menu' key 
APPUI WM KEY SIDE UP 'Side Up' key 
APPUI WM KEY UP 'Up navigation' key 
APPUI WM KEY DOWN 'Down navigation’ key 
APPUI WM KEY LEFT "Left navigation’ key 
APPUI WM KEY RIGHT 'Right navigation' key 
APPUI WM KEY START 'Call answer’ key 
APPUI WM KEY CALL END 'Call end’ key 
APPUI WM KEY CLEAR 'Clear' key 
APPUI WM KEY DIAL 0 ’0 key 

APPUI WM KEY DIAL 1 'V key 

APPUI WM KEY DIAL 2 '2 key 

APPUI WM KEY DIAL 3 '3 key 

APPUI WM KEY DIAL 4 '4' key 

APPUI WM KEY DIAL 5 ’5’ key 

APPUI WM KEY DIAL 6 '6 key 

APPUI WM KEY DIAL 7 °T key 

APPUI WM KEY DIAL 8 '8' key 

APPUI WM KEY DIAL 9 ”9 key 

APPUI WM KEY DIAL ASTERISK '+ key 
APPUI WM KEY DIAL NUMSIGN ’# key 
APPUI WM KEY F11 Function 11 key 
APPUI WM KEY F12 Function 12 key 
APPUI WM KEY F13 Function 13 key 
APPUI WM KEY F14 Function 14 key 
APPUI WM KEY F15 Function 15 key 
APPUI WM KEY F16 Function 16 key 
APPUI WM KEY F17 Function 17 key 
APPUI WM KEY F18 Function 18 key 


7.9.2.9 enum AppUIWmKeyNotificationType 
This enumeration is used to indicate the type of keypress notification. 


Enumerator: 
APPUI_WM_KEY_LONG_PRESS Indicates when a key is held down a long keypress will be re- 
ported. 


APPUI_WM_KEY_REPEAT_PRESS Indicates when a key is held down repeat key presses will be 
reported. 
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7.9.2.10 enum AppUIWmKeyPressNotification 


This enumeration is issued to indicate when the key notification should happen. 


Enumerator: 


APPUI WM KEY RELEASED Indicates key is notified when it has been released, this is only 
applicable to long key presses. 


APPUI_WM_KEY_PRESSED Indicates key is notified when it has been pressed, this is only appli- 
cable to long key presses. 


7.9.2.11 enum AppUIWmPrecedence 


This enumeration is used to indicate where newly registered applications are placed in the WM Stack. 


Enumerator: 


APPUI WM PRECEDENCE NORMAL Indicates default behaviour where newly registered ap- 
plications will be added to the bottom of the WM Stack. 


APPUI WM PRECEDENCE HIGH Indicates newly registered applications will be added above 
the default application. 


7.9.2.12 enum AppUIWmWinGrpPos 


This enumeration is used to indicate the position where the application's standard window group will be 
moved to. 


Enumerator: 
APPUI WM GRP BOTTOM Indicates the WM should move the standard window group to the 
bottom of the inter application window group. 


APPUI WM GRP TOP Indicates the WM should move the standard window group to the top of 
the inter application window group. 
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